요약

2.9.0 이후 병합된 외부 기여자 3개 PR(#31, #36, #37)을 묶어 2.9.1 패치 릴리즈로 내보내기 위한 릴리즈 PR입니다. 함께 2.9.0 상태에서 누락됐던 몇 가지 정합성 문제를 해소합니다.

포함 내용

1. docs: CONTRIBUTORS.md 추가 — 이번 릴리즈에 반영된 외부 기여를 기록합니다.

   • @seonghoony (fix(oxml): keep generated ids within signed int32 range #36, fix(data): rewrite bundled Skeleton.hwpx id to fit in signed int32 #37)
   • @hhy827 (fix(oxml): use _append_child for cell/run text + run-style modifier (closes #30) #31)
   • @devnoff (TypeError when using add_run(bold=True): stdlib ET.SubElement called on lxml element #30 재현/수정안 제보)
   • README.md, CONTRIBUTING.md에서 새 파일로 링크합니다.

2. chore(packaging): 2.9.1 버전 범프 + legacy license classifier 제거

   • pyproject.toml에 PEP 639 license expression과 legacy License :: OSI Approved :: Apache Software License classifier가 공존해 setuptools>=77 기준 pip install -e . / python -m build가 실패했습니다. classifier 제거로 해결했습니다.
   • 재현:
     ```
     InvalidConfigError: License classifiers have been superseded by license expressions (PEP 639).
     Please remove: License :: OSI Approved :: Apache Software License
     ```

3. docs: CHANGELOG 2.9.1 섹션 고정

   • 릴리즈 범위만 2.9.1로 분리하고, Unreleased에 있던 schema-validation 관련 항목은 그대로 Unreleased로 남겨 두었습니다(현재 머지되지 않은 feature 범위).

4. test(packaging): Apache-2.0 relicense 후속 정리

   • tests/test_packaging_license_metadata.py가 여전히 과거 LicenseRef-python-hwpx-NonCommercial을 검증하고 있어 dev deps 설치 시 실패했습니다. Apache-2.0 기준으로 정정했습니다.

검증

• 로컬(Python 3.11, lxml 5.4): `pytest tests/` → 253 passed, 2 skipped, 0 failed (skipped는 외부 샘플 패키지 부재 케이스).
• `python -m build` → sdist + wheel 모두 성공.
• 실전 회귀 확인 (2.9.0에서 깨지던 시나리오):
  • `add_run(bold=True)` ✅
  • subList 제거된 form 셀에 `cell.text = ...` ✅
  • 50 paragraph + 5 table 생성 후 모든 `id` 속성이 signed int32 내부에 존재 ✅
  • round-trip (save → open → re-save) ✅

머지 이후 해야 할 작업 (별도 PR/태그)

1. `main`에서 v2.9.1 태그 푸시 → GitHub Release 노트 작성 (contributors thank-you 포함).
2. PyPI 업로드 (Trusted Publisher 워크플로 또는 수동).
3. hwpx-mcp-server에서 `python-hwpx>=2.9.1` bump + `_patch_upstream_id_generators_to_signed_int32` shim 제거 PR.

연결 이슈

• TypeError when using add_run(bold=True): stdlib ET.SubElement called on lxml element #30 (close on merge)
• _paragraph_id / _object_id / _memo_id produce values that overflow signed 32-bit #34 (close on merge)
• Skeleton.hwpx ships with <hp:p id="3121190098"> (out of signed int32 range) #35 (close on merge)

검토 포인트

• CHANGELOG에서 Unreleased와 2.9.1 분리 경계가 의도하신 범위와 일치하는지 확인 부탁드립니다.
• CONTRIBUTORS.md 문구와 등재 기준이 이후 릴리즈에도 이어갈 수 있는 템플릿인지 점검해 주세요.